# 설치 단계

## 개요

소프트웨어 개발 및 데이터 공유 환경에서 **버전 관리**(Version Control)는 코드, 문서, 설정 파일 등의 변경 사항을 체계적으로 추적하고 관리하는 핵심 기술입니다. 버전 관리는 협업 개발을 가능하게 하고, 실수로 인한 손실을 방지하며, 이전 상태로의 복원을 간편하게 만들어 줍니다. 이러한 버전 관리 시스템을 사용하기 위해서는 우선 시스템에 해당 도구를 **정확하게 설치**하고 초기 설정을 완료해야 합니다.

본 문서에서는 대표적인 분산 버전 관리 시스템인 **Git**을 중심으로, 운영체제별 설치 단계와 기본 설정 과정을 상세히 설명합니다. 또한 설치 후 확인 방법과 주의사항도 포함하여, 초보자부터 숙련자까지 안정적으로 환경을 구축할 수 있도록 안내합니다.

---

## Git 설치 단계

Git은 Windows, macOS, Linux 등 주요 운영체제에서 모두 지원되며, 각 시스템별로 설치 방법이 다릅니다. 아래는 각 운영체제별 설치 절차입니다.

### Windows

1. **공식 사이트 방문**
   - [https://git-scm.com/](https://git-scm.com/) 접속 후 "Downloads" 클릭.
   - 자동으로 Windows용 설치 프로그램이 제공됨.

2. **설치 프로그램 실행**
   - 다운로드한 `Git-x.x.x.x-64-bit.exe` 파일 실행.
   - 설치 마법사가 시작되며, 기본 설정을 따르는 것이 일반적.

3. **주요 설정 옵션**
   - **Default editor**: 기본 텍스트 편집기 선택 (예: Vim, Nano, VS Code).
   - **PATH environment**: "Git from the command line and also from 3rd-party software" 권장.
   - **HTTPS transport backend**: 기본값 유지.
   - **Line ending conversions**: Windows에서는 "Checkout Windows-style, commit Unix-style" 선택 추천.
   - **Terminal emulator**: 기본 터미널로 "Use MinTTY" 선택.

4. **설치 완료**
   - "Finish" 클릭 후 Git Bash 또는 명령 프롬프트에서 `git --version` 입력하여 정상 설치 확인.

### macOS

#### 방법 1: 공식 설치 프로그램 사용

1. [Git 공식 다운로드 페이지](https://git-scm.com/download/mac)에서 `.dmg` 파일 다운로드.
2. 파일을 열고 "Git Installer"를 더블클릭하여 설치.
3. 안내에 따라 설치 완료 후 터미널에서 `git --version`으로 확인.

#### 방법 2: Homebrew 사용 (권장)

```bash
# Homebrew가 설치되어 있지 않다면 먼저 설치
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Git 설치
brew install git
```

### Linux (Ubuntu/Debian 계열 기준)

```bash
# 패키지 목록 업데이트
sudo apt update

# Git 설치
sudo apt install git

# 설치 확인
git --version
```

> **참고**: CentOS, Fedora 등 다른 배포판은 `yum install git` 또는 `dnf install git` 명령어를 사용합니다.

---

## 초기 설정

Git 설치 후, 사용자 정보를 설정해야 커밋 기록에 정확한 정보가 남습니다.

### 사용자 정보 설정

```bash
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
```

- `--global`: 시스템 전체에서 사용되는 전역 설정.
- 이후 모든 저장소에서 동일한 이름과 이메일 사용.

### 편집기 설정 (옵션)

```bash
git config --global core.editor "code --wait"
```

- 예: Visual Studio Code를 기본 편집기로 설정.
- Vim, Nano 등 다른 편집기로 변경 가능.

### 설정 확인

```bash
git config --list
```

- 설정된 모든 Git 옵션 출력.
- 이메일, 이름, 편집기 등이 정상 반영되었는지 확인.

---

## 설치 후 확인 및 문제 해결

### 정상 설치 여부 확인

```bash
git --version
```

- 출력 예: `git version 2.40.1`
- 명령어가 인식되지 않으면, PATH 설정 오류일 수 있음.

### 흔한 문제 및 해결 방법

| 문제 | 원인 | 해결 방법 |
|------|------|-----------|
| `git: command not found` | PATH에 Git 경로 미포함 | 설치 경로를 시스템 PATH에 수동 추가 |
| 인코딩 오류 | 한글 파일명 깨짐 | `git config --global core.quotepath false` 설정 |
| 줄바꿈 오류 | CRLF/LF 혼동 | `git config --global core.autocrlf true` (Windows) |

---

## 참고 자료

- [Git 공식 문서](https://git-scm.com/doc)
- [Pro Git 책 (무료 온라인)](https://git-scm.com/book/ko/v2)
- [GitHub Guides](https://guides.github.com/)

---

## 관련 문서

- [버전 관리 개요](버전_관리_개요.md)
- [저장소 초기화](저장소_초기화.md)
- [커밋과 히스토리 관리](커밋과_히스토리_관리.md)

> 본 문서는 Git 2.40.x 기준으로 작성되었습니다. 버전에 따라 일부 옵션이 다를 수 있습니다.